package com.muyu.marketing.bargain.service;

import com.muyu.marketing.bargain.domain.BargainRecord;
import com.muyu.marketing.bargain.domain.req.BargainRecordReq;

import java.util.List;

/**
 * 砍价记录Service接口
 * 
 * @author muyu
 * @date 2025-01-27
 */
public interface BargainRecordService {
    
    /**
     * 查询砍价记录列表
     * 
     * @param bargainRecord 砍价记录
     * @return 砍价记录集合
     */
    List<BargainRecord> selectBargainRecordList(BargainRecord bargainRecord);
    
    /**
     * 根据ID查询砍价记录
     * 
     * @param id 砍价记录ID
     * @return 砍价记录
     */
    BargainRecord selectBargainRecordById(Long id);
    
    /**
     * 根据用户ID和砍价商品ID查询砍价记录
     * 
     * @param userId 用户ID
     * @param bargainProductId 砍价商品ID
     * @return 砍价记录
     */
    BargainRecord selectBargainRecordByUserAndProduct(Long userId, Long bargainProductId);
    
    /**
     * 根据砍价商品ID查询砍价记录列表
     * 
     * @param bargainProductId 砍价商品ID
     * @return 砍价记录集合
     */
    List<BargainRecord> selectBargainRecordListByProductId(Long bargainProductId);
    
    /**
     * 根据用户ID查询砍价记录列表
     * 
     * @param userId 用户ID
     * @return 砍价记录集合
     */
    List<BargainRecord> selectBargainRecordListByUserId(Long userId);
    
    /**
     * 新增砍价记录
     * 
     * @param bargainRecordReq 砍价记录请求
     * @return 结果
     */
    int insertBargainRecord(BargainRecordReq bargainRecordReq);
    
    /**
     * 修改砍价记录
     * 
     * @param bargainRecord 砍价记录
     * @return 结果
     */
    int updateBargainRecord(BargainRecord bargainRecord);
    
    /**
     * 批量删除砍价记录
     * 
     * @param ids 需要删除的砍价记录ID
     * @return 结果
     */
    int deleteBargainRecordByIds(Long[] ids);
    
    /**
     * 删除砍价记录信息
     * 
     * @param id 砍价记录ID
     * @return 结果
     */
    int deleteBargainRecordById(Long id);
    
    /**
     * 开始砍价
     * 
     * @param userId 用户ID
     * @param bargainProductId 砍价商品ID
     * @return 结果
     */
    BargainRecord startBargain(Long userId, Long bargainProductId);
    
    /**
     * 执行砍价
     * 
     * @param userId 用户ID
     * @param bargainProductId 砍价商品ID
     * @return 砍价结果
     */
    BargainRecord executeBargain(Long userId, Long bargainProductId);
    
    /**
     * 完成砍价
     * 
     * @param id 砍价记录ID
     * @return 结果
     */
    int completeBargain(Long id);
    
    /**
     * 取消砍价
     * 
     * @param id 砍价记录ID
     * @return 结果
     */
    int cancelBargain(Long id);
    
    /**
     * 统计砍价商品的总砍价人数
     * 
     * @param bargainProductId 砍价商品ID
     * @return 砍价人数
     */
    Integer countBargainersByProductId(Long bargainProductId);
    
    /**
     * 统计砍价商品的成功砍价数
     * 
     * @param bargainProductId 砍价商品ID
     * @return 成功砍价数
     */
    Integer countSuccessfulBargainsByProductId(Long bargainProductId);
}